home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2002 #11 / Amiga Plus CD - 2002 - No. 11.iso / Tools / Freeware / CLVRWIN / CleverWIN.doc < prev    next >
Text File  |  2002-10-28  |  5KB  |  136 lines
  1.                  CleverWIN
  2.          © 1997-2002 by Stephan Rupprecht
  3.              All rights reserved.
  4.     
  5.  
  6. COPYRIGHT AND DISCLAIMER
  7.  CleverWIN is copyrighted 1997-2002 by Stephan Rupprecht. All rights 
  8.  reserved.This program is freeware, so no financial donations 
  9.  required. Redistribution allowed if the package is left unchanged.   
  10.  The author is not responsible for any damage caused by the 
  11.  use or misuse of this documentation and/or the program(s) it 
  12.  describes.
  13.  
  14.  
  15. REQUIREMENTS
  16.  Any Amiga® (compatible) computer with at least OS2.04.
  17.  
  18.  
  19. DESCRIPTION
  20.  The AmigaOS knows two methods of refreshing the contents of a window.
  21.  The first one (simple refresh) is slow but only requires a small amount 
  22.  of memory, whereas the second one (smart refresh) is much faster but 
  23.  requires a larger amount of memory.
  24.  CleverWIN is small patch that forces all programs to open their windows
  25.  in smartrefresh mode. Unfortunely, there are some programs which does
  26.  not work correctly when smartrefresh is used, for this purpose CleverWIN
  27.  allows you exclude certain tasks and pubscreens from getting patched.
  28.  This is especially useful for console windows (shell) which only feature
  29.  cut'n'paste in simplerefresh mode.
  30.  Starting 37.10 there's a new option called SIMPLE that tells CleverWIN
  31.  to force all windows into simple refresh mode. This is useful for hardware
  32.  where the memory interface between gfx memory and main memory is very
  33.  slow.
  34.  
  35.  
  36. INSTALLATION AND START
  37.  To install CleverWIN just drop its icon on a directory of your choice.
  38.  You can start CleverWIN either from shell or from workbench, the follow-
  39.  ing tooltypes/shell options are recognized:
  40.  
  41.  PUBSCREEN
  42.    This option allows you to define a pattern of all public screens which
  43.    should be patched by CleverWIN.
  44.  
  45.    Examples: 
  46.    PUBSCREEN=(Workbench|TCalc)
  47.     only windows opened on Workbench and TCalc screen will be 
  48.     patched.
  49.    PUBSCREEN=~(Workbench)
  50.     patch all windows, except those opened on Workbench.
  51.  
  52.    NOTE: This option does only affect public screens, standard
  53.            custom screen are not affected by it. Use the IGNORETASK 
  54.          option for custom screens instead!
  55.      Alternative choices (eg. Workbench|TCalc) and negated
  56.      expressions (eg. ~Workbench) must be placed in round 
  57.      brackets (as shown in the examples)!
  58.  
  59.  IGNORETASK
  60.    This one allows to exclude certain tasks from patching, this is
  61.    useful when a certain program doesn't correctly refresh its windows 
  62.    in smartrefresh (or simplerefresh, see below) mode.
  63.  
  64.    Examples:
  65.    IGNORETASK=Workbench    
  66.     This keeps CleverWIN from patching windows which are opened
  67.     by the workbench task.
  68.    IGNORETASK=(CON#?|dpaint#?)
  69.     CleverWIN will not patch console windows (Shell) and dpaint 
  70.     windows.
  71.  
  72.    NOTE: You should always use this pattern to make sure that
  73.          the cut`n`paste feature of console windows does not get 
  74.            lost. DPaint 4 does not work correctly in smart refresh 
  75.            mode!
  76.  
  77.  NOBACKDROPS
  78.    This option disables the patching of backdrops windows.
  79.  
  80.    NOTE: If you have a backdrop wb window, you should switch on this option 
  81.          to avoid graphical trash.
  82.  
  83.  SIMPLE
  84.    This tells CleverWIN to force windows into simple refresh mode, this
  85.    is useful for hardware with a slow gfx memory <-> main memory bus.
  86.  
  87.  
  88.  You can remove the patch by starting CleverWIN a second time. 
  89.  
  90.  
  91. SPECIAL THANKS TO
  92.    Damian Jurzysta for his error report and sending me a
  93.    newer version of notifyintuition.library.
  94.    Dirk Neubauer for his emails.
  95.    
  96.    
  97. HISTORY
  98.    37.0  first public release
  99.    37.1  error in the doc fixed, added Installer script
  100.    37.2  removed Enforcer hit, which was caused by write
  101.      access to rom. added PUBSCREEN option, removed
  102.            (buggy) SCREEN option.
  103.    37.3  improved PUBSCREEN option. CleverWIN is now a
  104.      commodity.
  105.    37.4  recompiled with MaxonDEVELOP, minor optimiziations,
  106.      changed version id from 39.x to 37.x 
  107.    37.5  added NOBACKDROPS option
  108.    37.6  internal release
  109.    37.7  totally rewritten: CleverWIN is no longer a commodity,
  110.      removed support for notifyintuition.library,
  111.      program terminates after patch has been installed
  112.      -> saves about 15-20kb of memory!
  113.    37.8  bugfix: patch code did not check all tags passed to
  114.      OpenWindowTagList(), fixed wrong example in the docs
  115.      (~Workbench -> ~(Workbench)), minor improvements
  116.    37.9     problems with PPaint 6.4 and Digita Organizer should
  117.      be fixed now.
  118.    37.10 added SIMPLE option by request.
  119.    37.11 made patchcode a bit more robust.
  120.  
  121.  
  122. AUTHOR
  123.  
  124. Please send bug reports and ideas to:
  125.  
  126.  Stephan Rupprecht
  127.  Apfeldweg 1
  128.  D44359 Dortmund
  129.  Germany
  130.  
  131.  Send emails to
  132.  
  133.  mail@stephan-rupprecht.de
  134.  
  135.  http://www.stephan-rupprecht.de
  136.